home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #1 / Amiga Plus 1995 #1.iso / fish-disketten / fish_761-770 / d765 / gambit_comp / readmefirst < prev    next >
Text File  |  1994-12-13  |  9KB  |  237 lines
  1.  
  2. ; FILE         "ReadMeFirst"
  3. ; IMPLEMENTS    Documentation/release-notes for the Gambit Scheme system
  4.                 version 1.8 for AmigaDOS 1.3/2.04, Motorola 68020/30/40.
  5. ; AUTHOR        This document: Ken Dickey;  The system: Marc Feeley.
  6. ; LAST UPDATED  1992 October 31
  7.  
  8.  
  9.  
  10. WHAT IS HERE
  11.  
  12. This is the complete Amiga sources and binaries for the Gambit Scheme
  13. System (GSS) by Marc Feeley.  The Scheme sources here have been
  14. compiled with Gambit and the C sources with the Lattice (now SAS)
  15. compiler v5.04 using the 1.3 includes.  It has been tested under 1.3
  16. and 2.04 with an Amiga 2000 using a GVP '030 upgrade and on various
  17. 500, 2000, and 3000 systems.  GSS implements the full R64RS and IEEE
  18. Scheme (P1178) Standards with extensions (see QuickTour). 
  19.  
  20. The compiler and sources for the compiler an interpreter are 
  21. included.  
  22.  
  23.  
  24. WHAT IS REQUIRED
  25.  
  26. The compiler requires a minimum of 3MB of RAM and a hard disk to do
  27. effective development, but generates very fast native 680x0 code.  The
  28. interpreter runs in about 1.5 MB.  You can link Scheme and C code,
  29. call C code from Scheme, and create stand-alone executable programs. 
  30.  
  31.  
  32. THE COMPILER *IS* SHAREWARE
  33.  
  34. This is shareware, folks (see Notes, below).  However, for a high
  35. quality native-code compiler with source the price, $40US, is not bad.
  36. Mark has put man years of work into this system and a check from a
  37. serious user will help keep him motivated to keep improving the
  38. compiler and runtime system.  {note, send checks to Marc, not to me.
  39. I am doing this because I think that Gambit is neat and to thank Marc
  40. for making it available --Ken}
  41.  
  42.  
  43. DISTRIBUTION FILES
  44.  
  45. lharc            -- use to unarcive files: lharc -r -x x gscompiler.lha
  46. gscompiler.lha   -- Gambit compiler & interpreter with sources.
  47. ReadMeFirst      -- this file
  48. more             -- used to read this file
  49. InstallToHardDisk -- read it, make a directory Gambit, cd Gambit and run.
  50.  
  51.  
  52. DISK and DIRECTORY STRUCTURE
  53.  
  54. If you have a hard disk make a directory, Gambit, and unpack the files
  55. into it.
  56.  
  57.  
  58. > makedir hd0:Gambit
  59. > cd hd0:Gambit
  60. > lharc -r -x x GambitCompiler1.8:gscompiler.lha
  61. > ASSIGN Gambit: DH0:Gambit
  62.  
  63.  
  64. FILES
  65.  
  66.     bin (dir)
  67.        gcv                              glk
  68.  
  69.      docs (dir)
  70.        benchmarks                       build.doc
  71.        compiler.doc                     Contents
  72.        Contents.info                    gsi.man
  73.        loadcompiler.scm                 OO-Scheme.YASOS
  74.        pvm                              QuickTour
  75.        ReadMeFirst                      repr
  76.        scheme-refs                      SchemeIntro
  77.  
  78.      sources (dir)
  79.  
  80.           loader (dir)
  81.             compile-runtime.68020            compile.68000+emul
  82.             compile.68020+FPU                convert-runtime
  83.             emul.c                           emul.h
  84.             ext.c                            ext_amiga.c
  85.             ext_unix.c                       gambit.h
  86.             gc.c                             gc.h
  87.             link-full                        link-full.emu
  88.             link-r4                          link-r4.small
  89.             link-r4.small.emu                link-short
  90.             link-short.emu                   link.h
  91.             link_me.c                        load.c
  92.             load.h                           main.c
  93.             main.h                           mem.c
  94.             mem.h                            opcodes.h
  95.             os.c                             os.h
  96.             os_amiga.c                       os_unix.c
  97.             params.h                         r4.gsi
  98.             r4_link.c                        r4_link_small.c
  99.             run.c                            run.h
  100.             short_link.c                     stats.c
  101.             stats.h                          strings.c
  102.             strings.h                        struct.h
  103.             temp1                            
  104.  
  105.           compiler (dir)
  106.             back.scm                         env.scm
  107.             front.scm                        host.scm
  108.             parms.scm                        ptree1.scm
  109.             ptree2.scm                       pvm.scm
  110.             scheme.scm                       source.scm
  111.             target-m68000-1.scm              target-m68000-2.scm
  112.             target-m68000-3.scm              utils.scm
  113.  
  114.           interpreter (dir)
  115.                macros (dir)
  116.                  expand.scm                       loadmacros.scm
  117.                  misc.scm                         syntaxenv.scm
  118.                  syntaxrules.scm                  test.scm
  119.                  usual.scm                        utils.scm
  120.             config.scm                       gsi.scm
  121.             header.scm                       _errors.scm
  122.             _eval.scm                        _multi.scm
  123.             _nonstandard.scm                 _numbers.scm
  124.             _ports.scm                       _r4rsSyntax.scm
  125.             _repr.scm                        _standard.scm
  126.             _system.scm                      
  127.  
  128.      tools (dir)
  129.        gcv.c                            glk.c
  130.  
  131.      objects (dir)  ;; compiled files (gambit compiled scheme code)
  132.  
  133.           compiler (dir)
  134.             back.O                           env.O
  135.             format.scm                       front.O
  136.             gsc.O                            gsc.scm
  137.             gsi.scm                          host.O
  138.             init.O                           init.scm
  139.             loadcompiler.scm                 loadcompiler.scm.info
  140.             parms.O                          ptree1.O
  141.             ptree2.O                         pvm.O
  142.             scheme.O                         source.O
  143.             target-m68000-1.O                target-m68000-2.O
  144.             target-m68000-3.O                utils.O
  145.  
  146.           interpreter (dir)
  147.             gsi.O                            _errors.O
  148.             _kernel.O                        _multi.O
  149.             _nonstandard.O                   _numbers.O
  150.             _ports.O                         _r4rsSyntax.O
  151.             _repr.O                          _standard.O
  152.             _syntax_eval.O                   _system.O
  153.             
  154.              
  155. LATE NOTE: ***
  156.  
  157. Note that I did not have enough room on the disk to include the large
  158. version of the interpreter.  I did include the small version which
  159. will run on a vanilla m68000, emulating the FPU and 68020 instructions.
  160. The interpreter is named "gsi.68k.small.emu" and requires the interpreter
  161. runtime system to be in a directory "Gambit:runtime".  If you unpacked the
  162. compiler to DH0:Gambit, then:
  163. >> ASSIGN Gambit: DH0:Gambit
  164. >> RENAME Gambit:objects/interpreter Gambit:runtime
  165. >> RENAME gsi.68k.small.emu C:gsi
  166.  
  167. This will allow you to run the interpreter and hence the compiler.
  168. You can build the larger version (which takes up more space but loads
  169. faster) from the sources as per docs/build.doc.
  170.  
  171. If you got the companion disk (GambitInterpreter1.8) then you have a
  172. choice of interpreter versions and can ignore this note.
  173.  
  174.  
  175. USAGE
  176.  
  177.  Copy bin/#? to your C: directory.
  178.  Invoke from the comand line as "gsi" {see gsi.man, QuickTour, & compiler.doc}
  179.  
  180.  
  181. OTHER DOCS
  182.  
  183. QuickTour        -- A Quick tour of the Gambit intepreter (Read This)
  184. build.doc        -- how to build stand-alone executables      
  185. compiler.doc     -- how to use the compiler
  186. gsi.man          -- man page for the interpreter (options & debug commands)
  187. pvm              -- Gambit Portable Virtual Machine specification
  188. repr             -- Gambit runtime REPResentations
  189. benchmarks       -- comparison with T (YALE) and LIAR (MIT) compilers
  190. scheme-refs      -- Books on Scheme
  191. SchemeIntro      -- An introduction to the Scheme Programming Language   
  192. OO-Scheme.YASOS  -- OO Scheme: Yet Anothe Scheme Object System
  193. loadcompiler.scm -- Code to load compiler files into the interpreter
  194.  
  195.  
  196. SCHEME EXTENSIONS
  197.  
  198. The ##System function allows you to exec calls; e.g. (##system "dir").
  199. Futures are supported.  The full numeric tower, including rationals,
  200. bignums, and complex math is supported: (sqrt -4) -> +2i .  Tracing
  201. and interactive debugging are also provided (see QuickTour).
  202.  
  203.  
  204. ; NOTES
  205.  
  206. At the present time, GSS only runs on M680x0 based computers
  207. (including M68000 to M68040).  GSS has been tested on SUN-3,
  208. HP9000/3xx, NeXT, Amiga and BBN GP1000 (Butterfly) computers.  A
  209. variant of GSS has also been ported to the Macintosh.
  210.  
  211. All Gambit code Copyright (C) 1992 by Marc Feeley.  Interpreter
  212. requires a 1.5MB and is Freeware.  The Compiler require a 3 MB
  213. Amiga and a hard disk.  
  214.  
  215. The compiler and all sources are ShareWare $40 (to Marc).
  216.  
  217.  
  218.                Marc's address is:
  219.  
  220.                       Marc Feeley 
  221.                       3260 Ridgewood Avenue, 
  222.                       Montreal, Quebec, Canada H3V 1B8
  223.  
  224.  
  225.                Amiga bugs and suggestions to Ken Dickey:
  226.                       kend@data.rain.com
  227.                       14565 SW McFarland, Tigard, OR, USA 97223
  228.  
  229.  
  230. Note that I am always extremely busy, but please do send comments on
  231. how to improve the distribution.
  232.  
  233. Enjoy!
  234. -Ken
  235.  
  236. ;;                      --- E O F ---                     ;;
  237.